Skip to content

Add Moderation API and stable response types#4

Merged
winrid merged 6 commits into
masterfrom
regen-moderation-api
Jun 19, 2026
Merged

Add Moderation API and stable response types#4
winrid merged 6 commits into
masterfrom
regen-moderation-api

Conversation

@winrid

@winrid winrid commented Jun 19, 2026

Copy link
Copy Markdown
Contributor

Moderation API

Adds a Moderation API with methods for the moderator dashboard:

  • Comments — list, count, fetch by id(s) and children, get/set comment text, logs, export, search (users / pages / sites / comments), suggestions
  • Moderation actions — remove / restore, flag / un-flag, set review / spam / approval status, adjust / cast / delete votes, reopen / close thread
  • Bans — ban from comment, undo ban, pre-ban and bulk pre-ban summaries, comment ban status, ban preferences, banned-user counts and lookup
  • Badges & trust — award / remove badge, manual badges, get / set trust factor, user internal profile

All Moderation methods accept an sso parameter for SSO-authenticated moderators.

Response types (breaking)

Each method now returns its success response type directly, with errors surfaced as a default error response, instead of the previous combined success-or-error return type. The response type names are now stable. Response shapes are unchanged.

Recommend a major version bump.

Regenerated from the updated OpenAPI spec (mirrors fastcomments-sdk@4.0.0).

- Add Moderation API (api_moderation.nim): 43 moderator-dashboard
  endpoints covering comment moderation (list/count/ids/search/logs/
  export), actions (remove/restore, flag/un-flag, review/spam/approval
  status, set text, votes, reopen/close thread), bans (ban/undo,
  pre-ban + bulk summaries, ban status/preferences, banned-user
  counts), and badges & trust (award/remove badge, manual badges,
  get/set trust factor, user internal profile). All accept an sso
  query param.
- BREAKING: endpoint methods now return their success type directly
  instead of an X | APIError union wrapper. APIError is now a default
  error response. Response shapes are unchanged.
- update.sh: normalize the generator's invalid trailing-underscore
  type reference for the generic GetCommentsResponseWithPresence
  <PublicComment> success type so the client compiles.
@winrid winrid changed the title Regenerate SDK: add Moderation API + stable response types Add Moderation API and stable response types Jun 19, 2026
winrid added 5 commits June 18, 2026 22:19
…on test

Generator now references model types by their declared camelized names, so
update.sh no longer seds the generated output. Updated the hand-written
integration test for the current response models (plain objects, getComments
fromDate/toDate params).
@winrid
winrid merged commit 3192af6 into master Jun 19, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant